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USER  MANUAL  FOR  VEHTRK  2.0  MODEL 
(CHEMVVAM  WITH  STAND-OFF  DETECTORS) 


This  user  manual  is  an  update  of  a  revised  excerpt  of  the  original  Honeywell-produced 
manual  for  the  Chemical  Vehicle  Vulnerability  Model  (CHEMVVAM).  All  the  text  is  identical 
to  that  in  the  original  except  for  revisions  (italics).  Revisions  are  based  upon  ERDEC 
modifications  to  the  code  and  implications  deduced  from  the  original  manual  and  program  usage. 


The  Vehicle  Track  (VEHTRK)  model  was  developed  by  Honeywell  to  interface  with 
cloud  transport  and  diffusion  models  in  computing  chemical  agent  concentration  and  dosage 
histories  outside  and  inside  combat  vehicles.  The  VEHTRK  2.0  model,  which  is  VEHTRK 
modified  to  accept  stand-off  detectors  wi*h  alarms,  allows  the  user  to  plot  a  route  for  one  or 
more  combat  vehicles,  to  move  the  vehicles  along  that  route,  to  generate  a  chemical  attack 
somewhere  along  that  route,  to  measure  the  external  and  internal  concentrations  of  chemical 
agent,  and  to  integrate  these  concentrations  into  dosages  outside  and  inside  the  vehicle. 


This  is  done  by  utilizing  previously-developed  partial  dosage  grids  to  obtain  the  dosage 
at  any  point  (x,y)  on  the  grid  at  any  gi’.  cn  time  t.  From  two  consecutive  times,  t,  and  tj,  the 
current  concentration  can  be  estimated  by  differentiation.  This  concept  was  combined  with  a 
point-to-point  vehicle  movement  model.  The  results  were  dosage  and  concentration  histories 
outside  the  vehicle  at  any  time  (t,)  and  any  point  on  the  battle  grid  (x„  y,).  The  model  also 
makes  use  of  a  pair  of  ventilation  parameters,  f  and  g,  which  are  related  to  the  ingress  and 
egress  rates  for  the  chemical  agent  and  the  combat  vehicle. 


The  VEHTRK  2.0  model 
also  allows  the  simulation  of  both 
point  and  stand-off  chemical  agent 
alarm  systems  by  including  data 
to  describe  the  alarm  response 
time,  the  communication  network 
for  a  group  of  vehicles, 
communication  network  time 
delays  and  delay  times  to  attain  a 
protective  posture,  given  an 
alarm. 


The  input  data  for  the 
VEHTRK  2.0  model  is  organized 
into  three  distinct  data  groups: 
scenario,  ventilation,  and  alarm. 
These  groupings  allow  the  user  to 
easily  set  up  parametric  studies  by 
swapping  large  segments  of  data 
via  the  three  data  type  files. 


TV  * 

!  » 


TARGET  AREA  COORDINATE  SYSTEM 


Figure  1 .  VEHTRK  Coordinate  Systems 
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Figure  1  illustrates  the  two 
coordinate  systems  used  in 
VEHTRK2.0.  The  lead  vehicle  of 
a  group  is  assumed  to  be  at  the 
origin  of  the  group  system  and 
move  from  point  to  point,  the 
other  vehicles  maintaining  their 
position  relative  to  the  lead 
vehicle.  The  left-most  vehicle  is 
the  one  with  the  greatest  positive 
offset  GY.  the  rightmost  is  at  the 
least  GY  value.  An  annotated 
sample  scenario  data  file  is  shown 
in  Figure  2.  A  description  of  each 
of  the  variables  and  the  size  of  the 
data  field  for  each  variable  in  each 
record  is  shown  in  Figure  3. 
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Cl/MGRP 

a/NVPG  NVPGL  NVPGR 
C3/IIV  GX  GY 
C3/IIY  GX  GY 
C3/IIV  GX.GY 
C3/IIV  GX  GY 
C3/I1V.GX  GY 
C3/IIV. GX.GY 
C3/i:V  GX.GY 
C3/IIV  GX  GY 
C3/IIV.GX  GY 
C4/NPPT 

SCO  0  CS/IPT.n  TY  TV  TSTOP 

0  0  C5/IPT  n.TY.TV  TSTOP 

C2/NVP6.NVPa  NVPGR 
C3/IIV.GX  GY 
C3/IIV.GX  GY 
C3/IIV.GX  GY 
C3/ 1 IV  GX.GY 
C3/IIV. GX.GY 
C3/IIV.GX  GY 
C3/Iiy  GX.GY 
C3/IIV.GX  GY 
C3/IIV. GX.GY 
C3/IIV  GX.GY 
C3/1IV.GX  GY 
C4/NPPT 

0  0  C5/IPT  TX.TY  TV  TSTOP 
0  0  CS/IPT.TV  TV  TV. TSTOP 
0  0  C6/T>iIN.TmX,T0ELT.TAn« 
C7/NaD  INUNIT 
16  0  CS/TCLD 
C8/TaD 

C9/IG  IV  CONFIG 
C9/IG  IV. CONFIG 
C9/IG  IV. CONFIG 
C9/IG.IV  CONFIG 
C9/IG. IV  CONFIG 
C9/IG. IV  CONFIG 
C9/IG  IV  CONFIG 
C97IG  IV  CONFIG 
C9/IG. IV. CONFIG 
C9/IG  IV. CONFIG 
C9/IG. IV. CONFIG 
C9/IG  IV. CONFIG 
C9/IG. IV. CONFIG 
C9/IG. IV. CONFIG 
C9/IG. IV. CONFIG 
C9/IG  IV  CONFIG 
C9/IG. IV  CONFIG 
C9/IG. IV. CONFIG 
C9/IG. IV. CONFIG 
C9/IG. IV. CONFIG 
CIO/NCONF 


Figure  2.  VEHTRK  Sample  Scenario  Data  File 
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Variable 

Format 

MGRP 

15 

NGRP 

15 

NVPGL 

15 

NVPGR 

15 

IIV 

15 

GX 

FIO.O 

GY 

FIO.O 

NPPT 

15 

IPT 

15 

TX 

FIO.O 

TY 

FIO.O 

TV 

FIO.O 

TSTOP 

FIO.O 

TMIN 

FIO.O 

TMAX 

FIO.O 

TDELT 

FIO.O 

TATTCK 

FIO.O 

RDELT 

FIO.O 

NCLD 

15 

Column  Unit 


1-5 


1-5 


6-15 


16-25 


1-5 


1-5 


6-15 


16-25 


26-35 


1-10 


11-20 


21-30 


31-40 


41-50 


-5 


Description 


Number  of  vehicle  groups 


Number  of  vehicles  in  I-th  group,  1 
<  I  <  MGRP 


Index  number  of  leftmost  vehicle  in 
the  group 


Index  number  of  rightmost  vehicle 
in  the  group 


Vehicle  index  number  within  group 


X-offset  from  lead  vehicle 


y-offset  from  lead  vehicle 


Number  of  points  in  group  route 


Route  point  index  number 


X-coordinate  of  route  point 


Y--oordinate  of  route  point 


Velocity  of  vehicle  as  it  leaves  this 
point 


Length  of  time  the  vehicle  is 
stationary  at  this  point  before 
leaving. 


Time  at  which  simulation  begins 


Maximum  simulation  time 


Incremental  time  step 


Time  of  chemical  attack  relative  to 
first  vehicle  point 


Step-size  for  line-of-sight  integration 


Number  of  partial  dosage  clouds  in 
cloud  file 


Note:  Records  2-5  must  be  repeated  for  each  group  before  continuing  to  Record  6. 


Figure  3.  VEHTRK  2.0  Scenario  Data  Description  (continued  on  next  page) 
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Record 

Variable 

Format 

Column 

Unit 

Description 

8 

TCLD 

5F10.0 

1-10 

11-20 

sec 

Times  of  sampling  for  partial 
dosage  clouds 

9 

IG 

15 

1-5 

Group  index 

IV 

15  6-10 

Vehicle  index  within  group 

CONFIG 

1015 

11-15 

16-20 

Configuration  index  at  each  pom* 
on  the  vehicle  route  (NPPT  values 
for  each  vehicle) 

10 

NCONF 

15 

1-5 

Total  number  of  hatch  con¬ 
figurations 

Figure  3.  VEHTRK  2.0  Scenario  Data  Description  (concluded) 


The  next  group  of  data  to  be  input  is  the  ventilation  parameters  F  (ingress)  and  G  (egress) 
for  each  of  the  vehicle  hatch  configurations.  These  are  shown  in  Figure  4,  an  annotated  sample 
ventilation  data  file.  A  description  of  each  of  the  variables  and  the  s!  ’  of  the  data  field  for  each 
of  the  variables  in  each  record  for  the  ventilation  data  file  is  shown  in-  Figure  5. 


1  .998565E+00  ,115214E-02 

Cll/IIV.F.G 

2  ,991745E+00  .784016E-02 

Cll/IIV.F.G 

3  .998565E+00  .115214E-02 

Cll/IIV.F.G 

4  ,990185E+00  ,760056E-02 

Cll/IIV.F.G 

1  4  0,1 

C12/AFLAG.ND1  .FPCON 

0.0  4.0  35.0 

70.0 

C13/00SLEV 

Figure  4.  VEHTRK  Sample  Ventilation  Data  File 

The  definitions  of  the  ventilation  coefficients  F  and  G  are  the  incoming  and  outgoing  exchange 
rates  of  the  vehicle,  determined  empirically  from  test  data.  In  terms  of  the  first  order  differential 
equation  for  the  ventilation  process: 

dC, 

— ‘  =  F-C,  -  GG 
dt 


where  C,  is  the  inside  concentration  and  C,  is  the  outside  concentration  at  time  t.  If  S,  and  S, 
are  defined  as  the  volumetric  flow  rates  into  and  out  of  the  vehicle,  which  has  total  interior 
volume  V.  then  F=(Sj-S.)/V  and  G  =  S,/V.  and  each  has  dimensions  of  time  '.  The  differential 
model  has  been  replaced  in  VEHTRK  2. 0  with  a  discretized  model  based  on  the  incremental  time 
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volume  V,  then  F=(S,-S2)/V  and  G=5/V,  and  each  has  dimensions  of  time  '.  The  differential 
model  has  been  replaced  in  VEHTRK  2.0  with  a  discretized  model  based  on  the  incremental  time 
TDELT.  Consequently  F  and  G  must  be  defined  with  units  ofTDELT',  i.e.  the  fractional  volume 
exchange  per  time  period,  a  concept  similar  to  compound  interest  rates. 


Record 

Variable 

Format 

Column 

Unit 

Description 

11 

1C 

15 

1-5 

Configuration  index 

F 

E12.6 

6-17 

TDELT' 

Ingress  coefficient,  volumetric 
exchange  per  time  period 

G 

E12.6 

18-29 

TDELT' 

Egress  coefficient,  volumetric 
exchange  per  time  period 

1 

AFLAC 

15 

1-5 

Alarm  flag: 

0=omit  alarms 

1  =use  point  alarms 

2= use  stand-off  alarms 

3= use  both  types 

NDL 

15 

6-10 

Number  of  dosage  levels  used  for 
casualty  assessment 

EPCON 

FIO.O 

11-20 

mg/m’ 

Smallest  agent  concentration  to 
consider  in  the  simulation 

13 

DOSLEV 

FIO.O 

1-10 

mg-min/ 

m’ 

Dosage  level  table  for 
casualty  assessment 

Figure  5.  VEHTRK  2.0  Ventilation  File  Data  Description 

A  sample  set  of  data  for  description  of  the  alarm  system  is  shown  in  Figure  6.  This  file 
is  not  included  if  AFLAC  =  0  or  2  on  record  12.  Some  notes  on  the  data  structure  are  very 
important: 

a.  Records  17  and  18  occur  in  pairs  for  each  point  on  the  alarm  response  curve. 

b.  The  response  curve  is  input  for  each  vehic'e;  that  is,  for  the  card  17  shewn  there 
are  four  values  of  0.19  corresponding  to  each  of  the  four  vehicles  with  alarms. 

c.  The  first  two  C19  records  correspond  to  the  alarm  warning  delays  from  vehicle 
1  to  each  of  the  other  20  vehicles  in  the  group. 
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4 

C14/NVA 

-i  -9 

-10 

-19 

C15/LVA 

5 

C16/NRT 

0.19  0.19 

0.19 

0.19 

C17/AC0N 

34.2  34.2 

34.2 

34.2 

C18/RTIM 

0.27  0.27 

0.27 

0.27 

C17/AC0N 

30.6  30.6 

30.6 

30.6 

C18/RTIM 

28.2  28.2 

28.2 

28.2 

C17/AC0N 

12.  12. 

12. 

12. 

C18/RTIM 

45.0  45.0 

45.0 

45.0 

C17/AC0N 

10.8  10.8 

10.8 

10.8 

C18/RTIM 

141.  141. 

141. 

141. 

C17/AC0N 

6.  6. 

6. 

6. 

C18/RTIM 

0  5 

5 

5 

5 

10 

10 

10 

5 

5 

C19/AWD 

10  10 

10 

10 

5 

10 

10 

10 

5 

5 

C19/AWD 

5  10 

10 

10 

10 

5 

5 

5 

0 

5 

C19/AWD 

10  10 

10 

10 

5 

10 

10 

10 

5 

5 

C19/AWD 

5  10 

10 

10 

10 

10 

10 

10 

5 

0 

C19/AWD 

5  5 

5 

5 

5 

10 

10 

10 

5 

5 

C19/AWD 

5  10 

10 

10 

10 

10 

10 

10 

5 

5 

C19/AWD 

10  10 

10 

10 

5 

10 

10 

10 

0 

5 

C19/AWD 

15. 

C20/TREACT 

Figure  6.  VEHTRK  Sample  Point  Alarm  Data  File 


A  description  of  each  of  the  variables  and  the  size  of  the  data  field  for  each  of  these 
variables  for  the  alarm  data  file  is  shown  in  Figure  7.  If  stand-off  alarms  are  being  used 
(AFLAG=2  or  3),  a  slightly  different  set  of  records  must  be  provided,  as  shown  in  Figure  8, 
either  additionally  or  instead.  Note  the  record  numbers  follow  the  point-alarm  data,  if  needed. 
The  program  reads  point-alarm  data,  followed  by  stand-off  alarm  data,  as  specified  by  AFLAG. 
It  is  assumed  that  the  reaction  time  of  personnel  is  independent  of  the  alarm  source,  so  TREACT 
is  only  read  once,  from  the  first  alarm  data  file.  While  users  may  use  this  as  an  excuse  to  omit 
the  TREACT  data  from  stand-off  alarm  files,  the  safest  rule  is  to  include  this  final  record  in  the 
input  stream  to  allow  the  exchange  of  input  file  elements  when  changing  scenarios. 
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Format 

Column 

15 

1-5 

1015 

1-5 

6-10 

11-15 

15 

1-5 

10F5.0 

1-5 

6-10 

10F5.0 

1-5 

6-10 

10F5.0 

1-5 

6-10 

F5.0 

1-5 

mg/m^ 


Description 


Number  of  vehicles  with  point 
alarms 


List  of  vehicles  with  alarms, 
by  index  number 
LVA  <  0  for  alarm  inside 
vehicle,  LVA  >0  outside 


Number  of  points  in  alarm 
response  time  curve 


Agent  concentration  at  alarm 


Alarm  response  time  for 
corresponding  cone. 


Alarm  warning  delay  for  i,j-th 
vehicle  pair 


Crew  reaction  time  to  don 
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Figure  7.  VEHTRK  2.0  Alarm  File  Data  Description 
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LVA  >  0  (outside) 


Horizontal  angle  of  LOS  with 
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Functional  range 
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Agent  CL  at  alarm 


Alarm  response  time  for 
corresponding  CL 


Alarm  warning  delay  for  i,j-th 
vehicle  pair 


Crew  reaction  time  to  don 
protective  gear;  needed  only 
if  AFLAC =2 


Figure  9.  VEHTRK  2.0  Stand-off  Alarm  File  Data  Description 


The  reader  has  possibly  noted  that  the  input  specifications  above  do  not  include  the 
specifications  for  the  partial-dosage  cloud  file.  Because  many  models  exist  to  generate  such 
files,  and  they  may  or  may  not  produce  files  with  a  format  compatible  with  VEHTRK  2. 0.  Figure 
10  is  provided  to  describe  the  data  specifications  expected  by  VEHTRK  2.0.  The  program  reads 
all  the  clouds  from  a  single  file  assigned  to  I/O  device  15.  The  clouds  must  be  ordered  by 
ascending  time  and  the  grid  points  must  be  constant  throughout  the  file.  Figure  8  provides  the 
format  expected  for  each  cloud  in  the  file. 
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Record 

Variable 

Format 

Column 

Unit 

Description 

1 

NX 

15 

m 

Number  of  points  on  x- 
axis 

NY 

15 

6-10 

Number  of  points  on  y- 
axis 

TIME 

FIO.O 

11-20 

sec 

Elapsed  time  after 
munition  function 
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1-11 

13-24 
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X  coordinates  in  cloud 
reference  system 
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10(E11.5.1X) 

1-11 

13-24 

m 

y  coordinates  in  cloud 
reference  system 

4 

GRDD 

10(E11.5,1X) 

1-11 

13-24 

mg-min/nf 

dosages  at  grid  points, 
reading  all  y  values  for 
each  X 

Figure  10.  Specifications  for  a  Single  Cloud  in  a  VEHTRK  2.0  Cloud  File 

A  sample  output  from  the  sample  input  is  shown  in  Figure  11.  The  first  part  of  the  output 
is  a  listing  of  pertinent  input  data  to  be  used  in  identifying  the  case  run.  Figure  12  provides  a 
description  of  the  output  column  headings.  Note  that  the  stand-off  detector/alarm  was  not  played 
in  this  sample. 
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Figure  1 1 .  VEHTRK  Sample  Output  (input  echo) 
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Figure  11.  VEHTRK  Sample  Output  (input  echo) 
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Figure  1 1 .  VEHTRK  Sample  Output  (concluded) 
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Figure  12.  Output  Column  Heading  Descriptions 
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